[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
##############################################################################
###+------+###################################################################
#+-| WAIT |------------------------------------------+########################
#| +------+ The WAIT command displays an optional or |########################
#| default prompt and allows for character |########################
#| input assigned to a character variable |########################
#+---------------------------------------------------+########################
##############################################################################
##############################################################################
#+--| Syntax |-------------------------+######################################
#| WAIT [<C-exp>] [TO <C-var>] |######################################
#+-------------------------------------+######################################
##############################################################################
##############################################################################
#########+---| Description |---------------------------------------+##########
#########| WAIT accepts one key from the keyboard. |##########
#########| ------------------------------------------------------- |##########
#########| A carriage return is printed before the prompt and/or |##########
#########| keyboard input unless the variable __cr_first is set |##########
#########| to FALSE. The carriage return and optional or default |##########
#########| prompt are displayed through the same I/O system as |##########
#########| the ? command. |##########
#########| ------------------------------------------------------- |##########
#########| <C-exp> |##########
#########| |##########
#########| If <C-exp> is specified, then it will replace the |##########
#########| default prompt. Otherwise, the message "Press any key |##########
#########| to continue . . ." will be displayed. |##########
#########| ------------------------------------------------------- |##########
#########| TO <C-var> |##########
#########| |##########
#########| If TO <C-var> is defined, then WAIT will assign the |##########
#########| keystroke to <C-var>, unless the key is escape. If |##########
#########| either enter, tab or backspace keys terminate the |##########
#########| WAIT command, their ASCII values are placed in <C-val>. |##########
#########+---------------------------------------------------------+##########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| * Pause to see if the user chooses to continue |#########
#########| |#########
#########| WAIT "Do you wish to continue? " TO input_var |#########
#########| IF input_var $ "Yy" |#########
#########| LOOP |#########
#########| ELSE |#########
#########| RETURN |#########
#########| ENDIF |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| * Pause the program without echoing to the screen. |#########
#########| |#########
#########| SET CONSOLE OFF |#########
#########| WAIT |#########
#########| RETURN |#########
#########+----------------------------------------------------------+#########
##############################################################################
See Also:
ACCEPT
INPUT
inkey()
lastkey()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson